home *** CD-ROM | disk | FTP | other *** search
/ United Public Domain Gold 2 / United Public Domain Gold 2.iso / utilities / pu063.dms / pu063.adf / HamLabDemo / Documentation / filt-ref.doc < prev    next >
Text File  |  1992-09-05  |  6KB  |  198 lines
  1. HAMLAB PLUS 2.0.8
  2. FILTER AND EXPORTER REFERENCE
  3.  
  4. (c) Copyright 1990-1992 J. E. Hanway.  All rights reserved.
  5.  
  6. IN THIS DOCUMENT:
  7.  
  8. INPUT FILTERS SUPPORTED
  9.  
  10. EXPORTERS SUPPORTED
  11.  
  12. ACKNOWLEDGEMENTS
  13.  
  14. INPUT FILTERS SUPPORTED
  15.  
  16. GIF (Graphics Interchange Format)
  17.  
  18.    GIF versions GIF87a and GIF89a are both supported.  (GIF89 features
  19.    are ignored.)
  20.  
  21.    Only the first image in the file is used.
  22.  
  23.    Non-interlaced GIF files require much less memory to convert than
  24.    interlaced GIF files. NOTE: This "interlace" has nothing to do with
  25.    the Amiga display.  An "interlaced" GIF file stores the lines of
  26.    the image in scrambled order, rather than top-to-bottom, so that,
  27.    in theory, you can see the overall picture sooner while it is
  28.    being displayed.  Most GIF files are not interlaced.
  29.  
  30.    Interlaced files, when opened, will also go through an extra step
  31.    during which a progress indicator will display "Buffering..."
  32.    During this time their line order is unscrambled.
  33.  
  34. TIFF (Tag Image File Format)
  35.  
  36.    Supports black&white or gray scale images with 1, 4, or 8 bit
  37.    planes.
  38.  
  39.    Supports RGB color images with 3, 12, or 24 bit planes.
  40.  
  41.    Images must either be uncompressed or use PackBits compression
  42.    (type 32773).
  43.  
  44. SPECTRUM 512
  45.  
  46.    Normal, compressed (.SPC) files supported. Uncompressed (.SPU) and
  47.    .SPS files are not supported.
  48.  
  49. PBMPLUS
  50.  
  51.    Black&white (PBM), gray scale (PGM), and color (PPM) files are all
  52.    supported.  Both ASCII and RAW (binary) formats are supported.
  53.  
  54. MTV
  55.  
  56.    The RAYSHADE ray tracer by Craig E. Kolb can also write images in
  57.    this format.
  58.  
  59. QRT, DKBTrace
  60.  
  61.    Although both the QRT and DKBTrace ray tracers use the same file
  62.    format, QRT uses only 21 bits of information per pixel while
  63.    DKBTrace uses 24 bits.  With default settings, DKBTrace pictures
  64.    will look correct, while QRT pictures will be too dark, but this
  65.    can be compensated by increasing the brightness.  (The easiest way
  66.    to do this is to load the color control settings from the
  67.    "QRT_color_response" file supplied.)
  68.  
  69. SUN RASTERFILES
  70.  
  71.    Black&white, 8-bit mapped color, and 24-bit color images are
  72.    supported.
  73.  
  74.    Both uncompressed and run-length compressed raster files are
  75.    supported.
  76.  
  77. IFF ILBM (and HAM-E)
  78.  
  79.   Supports normal, color-mapped, interleaved bit map images with one
  80.   to eight bit planes, plus HAM and HALFBRITE images.
  81.  
  82.   Also supports SHAM (sliced HAM), Dynamic HAM, Dynamic Hi-res, and
  83.   PCHG (multi-palette) files.  All versions of PCHG (12-bit and
  84.   24-bit, compressed and uncompressed) are supported.
  85.  
  86.   This filter will detect a HAM-E image and handle it properly.
  87.  
  88.   Both the HAM and REG modes of the HAM-E are supported.
  89.  
  90.   18-bit and 24-bit IFF files are also supported.  However, note that
  91.   in this release, any CLUT (Color Look-Up Table) chunks in the
  92.   file will be skipped.  In order to use the information in the
  93.   CLUTs, you may load them as color response curves.
  94.  
  95. Targa
  96.  
  97.   Reads Truevision Targa file types 1, 2, 9, and 10, with 16, 24, or
  98.   32 bits per pixel.
  99.  
  100. JPEG (Joint Photographic Experts Group)
  101.  
  102.   Supports JFIF, the JPEG File Interchange Format.
  103.  
  104.   JPEG files can use two kinds of compression: Huffman coding and
  105.   arithmetic coding.  Because supporting arithmetic coding would
  106.   require licensing a patent from IBM, it is not supported.
  107.   (Probably for this reason, Huffman coded JPEG images are much more
  108.   common.)
  109.  
  110. BMP (Windows bitmap, aka "Wallpaper" files)
  111.  
  112.   Reads uncompressed Windows Bitmap (.BMP) files with 1, 4, 8, or 24
  113.   bits per pixel.
  114.  
  115.   RLE compressed 4- and 8-bit BMP files are not supported.
  116.  
  117. GL (GRASP)
  118.  
  119.   This filter was contributed by John Bickers.  It reads .PIC and
  120.   .CLP files (types C, J, L, and M) which can be extracted from
  121.   MS-DOS GRASP (.GL) files using his GLSplit program.
  122.  
  123. EXPORTERS SUPPORTED
  124.  
  125. HamLab Temporary File Format
  126.  
  127.   Writes a simple, uncompressed 24-bit format.
  128.  
  129.   Args:
  130.         none
  131.  
  132. 24-bit IFF
  133.  
  134.   Writes 24-bit IFF files.
  135.  
  136.   Args:
  137.         none
  138.  
  139. EPS (Encapsulated PostScript)
  140.  
  141.   Writes a single page Encapsulated PostScript file.  The file may
  142.   be printed directly or imported into a publishing program that
  143.   supports EPS.
  144.  
  145.   Can create either a gray scale or full color PostScript image.
  146.  
  147.   Note: your printer must support the PostScript "colorimage"
  148.   operator in order to print HL+'s color postscript output.
  149.  
  150.   Args:
  151.         BW      gray scale output (default is color)
  152.  
  153. JPEG
  154.   Writes JFIF (Jpeg File Interchange Format) files.
  155.  
  156.   The amount of compression done in a JPEG file varies depending
  157.   on how much loss of quality you're willing to put up with.  The
  158.   JPEG exporter uses a quality setting of 1-100, where 100 is
  159.   the best quality (virtually lossless) and is the worst.  In
  160.   general, any setting above 95 is not a good idea bacause the
  161.   resulting file may be large.  Any setting below 10 is practically
  162.   unrecognizable, and some baseline JPEG readers may not be able
  163.   to read images with a quality of less than 25.
  164.  
  165.   The default quality setting is 75.  Whenever the filter is run,
  166.   it displays a requester allowing this to be changed.  The
  167.   requester may be suppressed by supplying the argument below
  168.   when the exporter is run.  (To do this, edit the HamLab.config
  169.   file or run the exporter from an AREXX command.)
  170.  
  171.   Args:
  172.         QUALITY=<qual>
  173.         Sets the quality (and suppresses the requester normally
  174.         used for entering the quality manually.)
  175.  
  176. ACKNOWLEDGEMENTS
  177.  
  178.    The GL (GRASP) filter was contributed by John Bickers.
  179.  
  180.    PostScript is a registered trademark of Adobe Systems, Inc.
  181.  
  182.    The Graphics Interchange Format(c) is the Copyright property of
  183.    CompuServe Incorporated.  GIF(sm) is a Service Mark property of
  184.    CompuServe Incorporated.
  185.  
  186.    Rayshade ray tracer by Craig E. Kolb.
  187.  
  188.    MTV ray tracer by Mark Vanderwetting.
  189.  
  190.    QRT ray tracer by Steve Koren.
  191.  
  192.    DKBTrace ray tracer by David K. Buck.
  193.  
  194.    PBMPLUS by Jef Poskanzer.
  195.  
  196.    The JPEG functionality is based on work by the Independent JPEG
  197.    Group.
  198.